home *** CD-ROM | disk | FTP | other *** search
/ Light ROM 1 / LIGHT-ROM 1 (Amiga Library Services)(1994).iso / ffdisks / d894.lha / CDTV-Player / Docs / readme < prev    next >
Text File  |  1993-07-17  |  16KB  |  411 lines
  1.    *******************************
  2.    **                           **
  3.    **      CDTV-Player 2.0      **
  4.    **                           **
  5.    **  designed in April 1993   **
  6.    **                           **
  7.    **      by Daniel Amor       **
  8.    **                           **
  9.    *******************************
  10.  
  11.    I. Introduction
  12.  
  13.    Welcome to CDTV-Player 2.0
  14.  
  15.    The idea for this program came up to me, as I was sitting in front of 
  16.    my CDTV and wanted to listen to some music and do some work at the 
  17.    same time. There is the possibility to press the play button while
  18.    working on Workbench, but nothing else than the track number will be
  19.    displayed. The other possibility to play Audio-CD's was to forget 
  20.    multitasking and use the built-in player-screen. I thought that 
  21.    this was quite lousy. In the German magazine 'AMIGA-DOS' I found a 
  22.    little program by Dr. Peter Kittel of Commodore - Germany in AMIGA-BASIC. 
  23.    This program looked more like a C-64 program with a lot of PEEKS and 
  24.    POKES. So I translated it into KICK-PASCAL (Lines in AmigaBasic vs 
  25.    Lines in Kick-Pascal = 200 vs 15) and designed a Workbench-Interface
  26.    (September 1992). This program is FISH-WARE. Commodore may even include 
  27.    this program into the original CDTV-package or bundle it with every CD-ROM.   
  28.    If you use this program for commercial matters, please don't forget to 
  29.    mention my name.
  30.  
  31.    II. Features
  32.  
  33.    CDTV-Player 2.0 features quite a lot of new options. First of all I
  34.    added preferences in order to keep the program user-friendly (this will
  35.    be extended in future versions). Then I've programmed a routine that
  36.    recognizes the CD if it's in the archive (thanks to Frédéric Botton - Paris 
  37.    for his «Gimme_a_CD»-program and the idea). Then I've introduced
  38.    a SHUFFLE function and an option to jump to seconds BACK and FORTH.
  39.    In earlier version only owners of a CD-ROM-drive could use the program.
  40.    Now everybody with an AMIGA has access to the archive in order to search 
  41.    for a song or just have a look at the program. I've included now an 
  42.    option called KARAOKE. If any lyrics are found in the archive they may
  43.    be displayed on-screen. Now an AREXX-Port has been included in order to
  44.    control the function of the CDTV from other programs.
  45.  
  46.  
  47.    III. Gadgets
  48.  
  49.    Here's a short explanation of the gadgets.
  50.  
  51.    REW     : Decreases track number.
  52.    PLAY    : Plays current track.
  53.    FF      : Increases track number.
  54.    PAUSE   : Pauses play.
  55.    STOP    : Stops play.
  56.    FADE    : Fades smoothly in/out.
  57.    LIVE    : Automatic fade in at the beginning of a track and automatic 
  58.              fade out a the end.
  59.    SINGLE  : Toggles between playing one song and the whole CD.
  60.    REPEAT  : Toggles between playing once or multiple times.
  61.    BACK    : Jumps two seconds back.
  62.    SCAN    : Scans into every song on the CD.
  63.    FORTH   : Jumps two seconds forth.
  64.    SECRET  : Future options.
  65.    KARAOKE : Live on-screen Karaoke (See V. KARAOKE).
  66.    SHUFFLE : Toggles between normal and shuffled play.
  67.    PROGRAM : Choose an order of play of your own.
  68.    PREFS   : Access to internal preferences. (See VII. PREFERENCES)
  69.    EDIT    : Opens edit window (See IV. EDIT).
  70.    DISPLAY : Toggles display-mode:
  71.              1. Track time played.
  72.              2. CD time played.
  73.              3. Remaining track time.
  74.              4. Remaining CD time.
  75.              5. No display (saves processing time).
  76.              Modes 3&4 accessible only with SINGLE off.
  77.    INFO    : Displays information.
  78.  
  79.    On the right side of the window there is a proportional gadget for
  80.    the volume.
  81.    
  82.     
  83.    IV. Edit
  84.  
  85.    WARNING: Not yet fully operational, but under heavy construction.
  86.  
  87.    By pressing the EDIT-Gadget in the main window, another window will be 
  88.    opened and you'll get access to the archive. In earlier version you had
  89.    to choose the CD you wanted to listen to from here. But this is done now
  90.    automatically, so you can only have a look at the archive now. You can have
  91.    a look at the songs by pressing the corresponding title. If CDTV-Player 
  92.    does not find the CD in the archive, you've got the possibility to
  93.    add this CD to the archive, by pressing the ADD CD-Gadget. A new window
  94.    will be opened and you've got the chance to enter the new CD. After 
  95.    quitting the window via the CLOSE-GADGET, the CD will be safed 
  96.    automatically to the archive. 
  97.  
  98.  
  99.    V. Karaoke
  100.  
  101.    When pressing the KARAOKE-Gadget in the main window, the program searches
  102.    for the lyrics of the actual song. If found in the archive, they will be
  103.    displayed on a seperate screen, while playing the song. At the moment 
  104.    there aren't any special effects, but I'm going to do this in the near
  105.    future (all ideas are welcome). If you want to create own KARAOKE-songs,
  106.    have a look at 'lyrics:depeche mode.mx' (the only complete one, since I'm
  107.    too lazy to key in all lyrics). When a genlock is available, you may use 
  108.    it for KARAOKE.
  109.  
  110.  
  111.    VI. Archive
  112.  
  113.    WARNING: Format of archive is still under heavy construction. Please do 
  114.             not assume that future versions will support the actual format
  115.             of the archive.
  116.  
  117.    The archive is divided actually into two parts. The first part includes
  118.    the group names and the CD titles, CD time, number of tracks (e.g. Brian 
  119.    Adams, Waking up the neighbours,74:54.38|15). In earlier version I 
  120.    omitted the fractions of the second and the number of tracks, but that was
  121.    not very precise for finding the right CD in the archive and so I had to 
  122.    include them, too. Have a look at Lyrics/A-ZMusix in order to learn
  123.    how to build own archives. The second part of the archive consists of 
  124.    the group-files with the track titles and the lyrics.
  125.  
  126.  
  127.    VII. Preferences
  128.  
  129.    In this menu you may alter the internal preferences for some functions.
  130.    On the left side there are two slider-gadgets. With the upper one you
  131.    may choose the time for fading in & out at the beginning and the end
  132.    of a track (1sec - 10sec). With the lower one you can choose the time for 
  133.    scanning into each track (5sec - 25sec). On the right there are two
  134.    check boxes which are both related with the KARAOKE-Feature. Break 
  135.    enables you to quit the KARAOKE whenever you want (a close-gadget 
  136.    appears on-screen) and Time puts the playing time on the KARAOKE-Screen.
  137.    This has been introduced to ease the input of new KARAOKE-Titles.
  138.  
  139.  
  140.    VIII. The future
  141.  
  142.    I'll include a function called COPY, which will simplify the COPY
  143.    of CD's to a cassette. You'll just key in the exact amount of time you
  144.    want to be copied and the program will select the songs in order to
  145.    match your timing (or as close as possible).
  146.  
  147.    If the program works with the A570/A670 CD-ROM-Drives, I would introduce
  148.    an AREXX-Port. This would enable other programs to use the functions
  149.    of the CDTV-Player for their own use (for example Multi-Media-
  150.    Applications). NOW INCLUDED.
  151.  
  152.    I'll try to use PARNET for my program in order to use e.g. an AMIGA 4000
  153.    for KARAOKE while playing from CDTV (i.e. more & faster effects).
  154.  
  155.    I'll try to extend the program in order to use it with SCSI-Drives (if
  156.    anybody has any information on SCSI-Drives, please write).
  157.  
  158.    If somebody out there has some other suggestions, needs or useful
  159.    information then please write to me. (See XII. Credits).
  160.  
  161.  
  162.    IX. Source-Code
  163.  
  164.    You can get the source-code for free, if you write to me and send a disk.
  165.    Suggestions and ideas are welcome. New groups for the archives are also 
  166.    welcome. CDTV-Player was written in KICK-PASCAL 2.12.
  167.  
  168.  
  169.    X. Assigns
  170.  
  171.    For the moment, you'll have to do one ASSIGN in order to be able to 
  172.    load the Archive (I'm sorry). For example, if you've got the directory 
  173.    CDTV-Player in DF1:, then ASSIGN Lyrics: DF1:CDTV-Player/Lyrics. I've 
  174.    included a script for this purpose.
  175.    
  176.  
  177.    XI. Arexx
  178.  
  179.    Arexx has been introduced in order to gain control over CDTV-Player from
  180.    other programs. Please refer to the examples on the disk. At the moment
  181.    you can only start a track and stop it again. In future releases you'll
  182.    get complete control over the program.
  183.    
  184.  
  185.    XII. History of CDTV-Player
  186.  
  187.    Version 0.8 (12.09.92)
  188.  
  189.    Translation of the AMIGA-BASIC-Program by Dr. Peter Kittel into
  190.    KICK-PASCAL. Plays songs from CLI/SHELL without Workbench Interface.
  191.  
  192.    Version 0.9 (14.09.92)
  193.  
  194.    Added Workbench Interface in order to play songs without a keyboard.
  195.    Added features like PAUSE, SCAN, SINGLE, REPEAT, FADE, DISPLAY.
  196.  
  197.    Version 1.0ß (18.09.92) Fish-Disk 759
  198.  
  199.    First release with a lot of bugs in it (e.g. it didn't recognize if a
  200.    CD was taken out of a drive or a floppy disk). Added an INFO-Window.
  201.    Changed internal handling of 'cdtv.device'. Thought of a function 
  202.    called KARAOKE, but did not know how to do it.
  203.  
  204.    Version 1.2 (26.10.92)
  205.  
  206.    Redesigned Workbench Interface and added the KARAOKE window. This had 
  207.    nothing to do with KARAOKE, but you could choose the titles of a CD to be 
  208.    displayed while playing it. Removed all bugs concerning the disk-change
  209.    problem. 
  210.  
  211.    Version 1.3 (05.11.92)
  212.  
  213.    Added message for all people who don't own a 'cdtv.device'. Increased
  214.    speed of overall program and reduced usage of processing time.
  215.  
  216.    Version 1.4 (26.11.92)
  217.  
  218.    Added some bugs while removing some others. Many internal changes (You 
  219.    can't 'see' a difference between 1.3 and 1.4, but 1.4 is more stable).
  220.  
  221.    Version 1.5 (25.12.92) Fish-Disk 805
  222.  
  223.    Increased size of KARAOKE window, added some gadgets to it. Renewed
  224.    the documentation and increased speed again. Removed all nasty bugs
  225.    concerning the KARAOKE option.
  226.  
  227.    Version 1.5d (29.12.92)
  228.  
  229.    Removed a little bug in the info-requester that caused sometimes a crash.
  230.    It's a pity, that I've sent the disk four days ago.
  231.  
  232.    Version 1.6 (11.01.93)
  233.  
  234.    Renamed KARAOKE as EDIT, since I haven't got the time to implement 
  235.    a real KARAOKE function for the moment. Increased speed of EDIT 
  236.    output due to change to dynamic structures (well, at least one thing
  237.    I could use from university). Moved to AMIGA 4000 for designing code 
  238.    (more memory, more fun). Added SHUFFLE.
  239.  
  240.    Version 1.7f (25.01.93)
  241.  
  242.    Third official release of CDTV-Player. Now everybody with an AMIGA is
  243.    able to get into the program and have a look at the gadgets and use
  244.    the EDIT function in order to look for a certain song. Added a search
  245.    function in order to find the actual CD in the archive and load it 
  246.    automatically. Added PREFS, BACK & FORTH.
  247.  
  248.    Version 1.7j (20.02.93)
  249.  
  250.    Added a PROGRAM function and now it's possible to key in your own
  251.    CD's. Removed quite a lot of unnecessary code. Improved design of EDIT.
  252.    Removed bugs in SHUFFLE & PROGRAM (internal the same procedure).
  253.  
  254.    Version 1.8 (22.02.93) Fish-Disk 849
  255.  
  256.    Fourth official release of CDTV-Player. Included KARAOKE (very popular in 
  257.    Japan & Italy). Every text may be used for this option. Also included 
  258.    ADD CD, in order to key in new CD's.
  259.  
  260.    Version 1.9 (23.03.93)
  261.  
  262.    Added more preferences in order to toggle features of KARAOKE. Now Karaoke
  263.    may be stopped at any time and it's possible to have a look at the playing 
  264.    time. Increased speed of KARAOKE-Screen-Output and removed some unnecessary
  265.    code.
  266.  
  267.    Version 2.0 (04.04.93) Fish-Disk 868
  268.  
  269.    Fifth official release of CDTV-Player. Now incorporates an AREXX-Port. This
  270.    enables you to use the functions of CDTV-Player from other programs.
  271.  
  272.    Version 2.01 (23.04.93)
  273.  
  274.    Aaaargh. V2.0 did not work on machines where the arexx.library was not 
  275.    installed. Didn't notice until now, since I was using Arexx on my CDTV.
  276.  
  277.    Version 2.02 (13.06.93)
  278.  
  279.    Disabled AREXX, due to timing problems. Enhanced the ADDCD-Function.
  280.  
  281.    Version 2.03 (28.06.93)
  282.  
  283.    Enabled AREXX again, because all problems concerning it have been 
  284.    removed.
  285.  
  286.    Version 2.05 (13.07.93)
  287.  
  288.    Removed BUG in ADDCD-Function. Now it saves without any problems (made a
  289.    work-around for a compiler-bug). REW & FF are now ghosted if there is no
  290.    higher or lower track.
  291.  
  292.  
  293.    XIII. Credits
  294.  
  295.    (In alphabetical order)
  296.  
  297.    Thomas Bengtsson - SWEDEN,
  298.      for his e-mail & the interest in the source.
  299.  
  300.    Tomi Blinnikka, Helsinki - FINLAND,
  301.      for his e-mail & for his interest in the source.
  302.  
  303.    Frédéric Botton of EDUCOM, Paris - FRANCE,
  304.      for his «Gimme_a_CD»-program, his ideas, his quadrolingual letters 
  305.      & e-mails and his fine sense of humour.
  306.  
  307.    Ioannis Chatziandreou, Bochum - GERMANY,
  308.      for his e-mail & his urgent need of the source.
  309.  
  310.    Ross Delaforce - AUSTRALIA,
  311.      for his e-mail & the SCSI-idea.
  312.  
  313.    Marc Eisenach, Stadtallendorf - GERMANY,
  314.      for his phone calls, the conversation about CDTV and for various
  315.      information about the hardware.
  316.  
  317.    Hans-Christian Eckert, Berlin - GERMANY,
  318.      for his e-mails, his suggestions and the interest in the source.
  319.  
  320.    Darren Ewaniuk, Alberta - CANADA,
  321.      for his e-mail & for the inclusion of CDTV-Player into his products.
  322.  
  323.    Fred Fish, Tempe - USA,
  324.      for the inclusion of my programs in his wonderful collection.
  325.  
  326.    Wlad Fomin & Dostick of ACL, Riga - LATVIA,
  327.      for their e-mails, Russian letters, their interest in CDTV & AMIGA
  328.      and their support.
  329.  
  330.    Imke Gisch, "Produktmanager CDTV" of Commodore - GERMANY,
  331.      for fast access to the documents.
  332.  
  333.    Dave Hassall - NEW ZEALAND,
  334.      for his e-mail and the interest in CDTV-Player.
  335.  
  336.    Kai Hofmann, Bremen - GERMANY,
  337.      for his e-mails & the interest for CDTV.
  338.  
  339.    Jason R. Hulance, Oxford - GREAT BRITAIN,
  340.      for his e-mails & the interest in the source.
  341.  
  342.    D. Jarvis - USA
  343.      for his e-mail & the interest in the source.
  344.  
  345.    Dr. Peter Kittel of Commodore - GERMANY,
  346.      for his AMIGA-BASIC-Program and the article in the "AMIGA-DOS".
  347.  
  348.    George Knighton, Fremont - USA,
  349.      for his letter and his interest in CDTV-Player.
  350.  
  351.    Tom Kroener, Saarbrücken-Dudweiler - GERMANY,
  352.      for his letters, criticism and ideas.
  353.  
  354.    Gerhard Leibrock, Kirkel - GERMANY,
  355.      for his letters and his ideas.
  356.  
  357.    Thomas J. Moore - USA
  358.      for his e-mails, his bug-reports and his nice suggestions
  359.      (look out for his C version of CDTV-Player).
  360.      
  361.    Arthur T. Murray, Seattle - USA,
  362.      for his postcard.
  363.  
  364.    Nhan Nguyen, Sophomore - USA
  365.      for his interest in the CDTV-Player, his ideas and his e-mails.
  366.  
  367.    Stefan Ohlin, Solleftea - SWEDEN,
  368.      for his interest in the CDTV-Player and in the source.
  369.  
  370.    Oliver Peike - GERMANY
  371.      for his e-mail.
  372.  
  373.    Alfred Prenner, Fürstenfeldbruck - GERMANY,
  374.      for his letter and the interest in CDTV & Parnet.
  375.  
  376.    Hanns Holger Rutz, Zeven - GERMANY,
  377.      for his letters, his ideas and bug-reports.
  378.  
  379.    Peter Uitz, Vienna - AUSTRIA,
  380.      for his interest in the documentation for the CDTV.
  381.  
  382.    Federico Villata, Rome - ITALY,
  383.      for his e-mail and his interest for the CDTV-Player.
  384.  
  385.    Jure Vrhovnik, Ljubljana - SLOWENIA,
  386.      for his interest in CDTV, his e-mails and his hardware
  387.      specifications (dream on).
  388.  
  389.    Werner Völker, Ebersbach - GERMANY
  390.      for his phone call and the talk about CDTV, AMIGA & PARNET.
  391.  
  392.    to be continued...
  393.  
  394.    (If you like my program, please let me know, then you'll be 
  395.     mentioned here)
  396.  
  397.    ***************************************************************
  398.    **                                                           **
  399.    **                 You may write to me in                    **
  400.    **   Ceský, Deutsch, English, Français, Italiano, Russkij.   **
  401.    **                                                           **
  402.    **  Snail Mail: Daniel Amor                                  **
  403.    **              Ludwigstr. 124                               **
  404.    **              70197 Stuttgart                              **
  405.    **              Germany                                      **
  406.    **                                                           **
  407.    **  E-Mail:     amor@student.uni-tuebingen.de                **
  408.    **  FidoNet:    2:2407/106 (Intuition Base)                  **
  409.    **                                                           **
  410.    ***************************************************************
  411.